home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / misc / 606 / upgrade.200 < prev   
Encoding:
Text File  |  1992-09-05  |  9.7 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                    Upgrade Instructions for Version 2.00
  7.  
  8.  
  9.           This file is *ONLY* for users upgrading from TODAYS.PRG
  10.      version 1.99 to version 2.00.  If you are a new user, or are
  11.      upgrading from a release prior to 1.99, *PLEASE* read the
  12.      documentation on how to set up TODAYS.PRG.  There have been a
  13.      LARGE number of changes since version 1.98!
  14.  
  15.                            Changes to TODAYS.LNG:
  16.  
  17.           Please replace your current TODAYS.LNG file with the one
  18.      included in the distribution package.  There have been a number of
  19.      changes and enhancements.  The program will abort if you fail to
  20.      do so.
  21.  
  22.                            Changes to TODAYS.INF:
  23.  
  24.           Line 5 has been deleted!  Please make this change BEFORE you
  25.      do anything else!  Simply load TODAYS.INF into your favorite Text
  26.      Editor/Word Processor and delete the line out completely, pulling
  27.      up the rest of the lines in the file.  For those of you who still
  28.      want/need to use a 'header',  please see the new code (%FEXT) in
  29.      the TODAYRPT.FMT file.
  30.  
  31.           Next, insert a line in between the Wrap Value and the
  32.      Carridge return code making a new line 8 and pushing the rest of
  33.      the lines down.  On this line, place a number between 0 and 32767.
  34.      This number will be for the number of spaces from the left edge of
  35.      the screen to where you want the text to start should a line be
  36.      wraped around.  (It'll have no effect if the lenght of the text is
  37.      less then your Wrap Value.)
  38.  
  39.           After making those changes, your file should be like the one
  40.      shown below, adjusting for your individual systems of course.
  41.  
  42.      line#       Meaning:
  43.      -----   -------------------------------------------------------
  44.       1      Location of TODAY.mmm files
  45.       2      Extenders of additional TODAY.xxx files
  46.       3      Location of alternate file (1 big file)
  47.       4      Where to send the output to
  48.       5      What to do if there's already a existing file (append or
  49.                replace)
  50.       6      Age value
  51.       7      Wrap value
  52.       8      Second line indents on wraped lines (# of spaces)
  53.       9      Carridge return codes (3 digits each character
  54.      10      Sort or NoSort of output dates.
  55.      11      Show where the data came from (which file)
  56.      12      Maximum number of items to collect
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                    - 1 -
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.            To allow you to set your own 'seperator' that goes between
  73.      the year and the text, a new line, number 13, now allows you to
  74.      'define' that.  This is the dash that used to be hard coded into
  75.      the program.  A space will be added to the text on this line
  76.      unless you enclose the text you want in quote marks ("). Examples:
  77.  
  78.      If line 13 is:
  79.      -         ; String to put between the year and the text
  80.      you will get:
  81.        1992 - Year of the Frog.
  82.  
  83.      If line 13 is:
  84.      "-"         ; String to put between the year and the text
  85.      you will get:
  86.        1992-Year of the Frog.
  87.  
  88.      If line 13 is:
  89.      <>         ; String to put between the year and the text
  90.      you will get:
  91.        1992 <> Year of the Frog.
  92.  
  93.      If line 13 is:
  94.      "<>"         ; String to put between the year and the text
  95.      you will get:
  96.        1992<>Year of the Frog.
  97.  
  98.           In addition, to allow you to change the text color,
  99.      background color or the font that's used to do the text on the
  100.      line, 2 more optional lines have been added to the TODAYS.INF
  101.      file.
  102.  
  103.           Line 14 sets the text before the year, and line 15 sets it
  104.      before the text.
  105.  
  106.           You can also use line 13 to set the color before the prompt
  107.      as well as for defining the prompt, so you can now control all
  108.      three 'display' areas.
  109.  
  110.           NOTE: You do *not* have to use lines 13, 14 and 15!  You do
  111.      not even have to have them in your TODAYS.INF file.  These lines
  112.      are for those users who want access to those areas to make
  113.      whatever changes they want to them.  TODAYS.PRG does not require
  114.      your use of them!
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                    - 2 -
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                            Changes to TODAYS.RPT:
  139.  
  140.                             MASSIVE CHANGES!!!!
  141.  
  142.           Your old report will no longer work!  *ALL* the codes have
  143.      been changed!  Please see the TODAYRPT.FMT file included in the
  144.      distribution package to determine what the new codes are and which
  145.      ones you want to use.  I think you'll like the new code structure,
  146.      and find it's faster and easier to use, as well as being more
  147.      flexable!
  148.  
  149.           To help 'convert' your old TODAYS.RPT file over to the new
  150.      code structure, I wrote a program called TUPDATE.PRG which is
  151.      included in the distribution package.  It requires that the
  152.      associated file "TUPDATE.MAP" be in the same directory as the
  153.      program when you run it.
  154.  
  155.           A number of new codes have also been added to allow users
  156.      more choice in the information they want displayed.  Hopefully,
  157.      this won't prove _too_ much for users to handle, as there are a
  158.      few codes I still want to add.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                    - 3 -
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                        Program fixes / enhancements:
  205.  
  206.           The program will now properly replace the output file when
  207.      the user puts 'Replace' on line 5.  Previous versions gave an
  208.      error 24 when the user attempted to replace the existing output
  209.      file.
  210.  
  211.           The rather offensive (to some users) 'reset screen' code that
  212.      was sent out at the end of the TODAYS.PRG run has been deleted.
  213.      Sorry 'bout that.
  214.  
  215.           The program can now handle function codes on the lines from
  216.      the data files.  ALL of the function codes are available in the
  217.      lines plus 7 additional ones that will only work on the lines.
  218.      Please see TODAYRPT.FMT for the codes and what can be done.  This
  219.      allows the user even greater flexability when designing their
  220.      reports.
  221.  
  222.           I've been told that I was wrong about Stardates.  I watched a
  223.      couple of episodes of Star Trek: The Next Generation, and
  224.      discovered that what I was told about them was indeed wrong:
  225.      Stardates are FIVE digits long, not four.  <sigh>  A four digit
  226.      Stardate only covers about 27 years, which doesn't make much sense
  227.      when compared to Gregorian years.  A five digit Stardate covers
  228.      about 273 years.  That doesn't make much sense to me either, but
  229.      it does make more sense then a measly 27 years.  For those of you
  230.      would prefer the 4 digit version, you can 'trim' it with the
  231.      function code (%FSTDNNR4%).
  232.  
  233.           The way the program handles the 'Pre-year' and 'Pre-text'
  234.      strings (for color and/or font changing) has been changed due to
  235.      the inclusion of the the function codes in the lines.
  236.  
  237.           Since the user can now put the year (or whatever) anywhere
  238.      they want on the line, to use them only before the beginning of
  239.      the line makes no sense.  So the 'before year' string is now sent
  240.      out before each function code in the lines, and the 'before text'
  241.      string after the function code.
  242.  
  243.           This _may_ distort the line wrapping if you're using 'hidden'
  244.      characters in your strings to change the colors and/or fonts so
  245.      that it appears that the wrap function isn't working correctly.
  246.      Remove the 'pre-year' and 'pre-text' strings, and you'll find that
  247.      the wrap is indeed functioning correctly.  The wrap function
  248.      'counts' those 'hidden characters' as characters, and it'd be a
  249.      near impossible feat to 'fix' it so that it wraps the line without
  250.      reguard to them.  If someone knows of a way that I haven't thought
  251.      of though, I'd be more then pleased to hear it!
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                    - 4 -
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.           When function codes are used in the lines, the lines are
  271.      lined up differently then on lines without them.
  272.  
  273.           The lines, which used to always have the year first, were
  274.      aligned so that all the years lined up, along with the year/text
  275.      seperator string and the text on the line.  With lines that have
  276.      function codes on them, the lines are *not* lined up with the
  277.      other lines.  The left edge of the screen is where the text
  278.      starts, and the year that is on the line is not displayed unless
  279.      the user chooses to display it with a function call.
  280.  
  281.           With the addition of the function codes to the lines, the
  282.      Anniverary 'group' is redundant and unnessesary, so I've deleted
  283.      them.  You may still use type $ codes for your anniversary events,
  284.      however you'll have to add in a function call on the line
  285.      (%FYERNSN%) to get the year with suffex out.
  286.  
  287.           Error reporting has changed.  You'll still get the TODAYS.ERR
  288.      file, but the errors are no longer shown on the screen as they are
  289.      discovered.  Instead the screen will display a message at the end
  290.      of the program run requesting that the user look at the TODAYS.ERR
  291.      file and then pause for 30 seconds before continuing on.  Pressing
  292.      any key durring the 30 second pause will abort the pause, and the
  293.      program will continue on.
  294.  
  295.           An error in the TODAYS.RPT file will no longer cause the
  296.      program to switch over to the 'built in default' report.  Instead,
  297.      the function call will not be converted, and the program will
  298.      continue on to convert the other function codes in the file,
  299.      ignoring the bad one.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                    - 5 -
  330.  
  331.